home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / xyzshl34.lzh / XYZSHELL.DOC next >
Text File  |  1991-03-22  |  7KB  |  185 lines
  1.  
  2.  
  3.                        XYZSHELL version 3.3
  4.  
  5.  
  6.  With my being able to get ahold of the latest version of  XYZ.TTP 
  7. version 2.0 (the shareware version), I quickly set about expanding 
  8. the  shell to work with the new version.  The new XYZ.TTP is  well 
  9. worth  the small amount of donation that the author Alan  Hamilton 
  10. requests and we all should contribute to this highly needed multi-
  11. transfer protocall program.
  12.  
  13.  SETUP
  14.  -----
  15.  
  16.  Place the following files into the same directory:
  17.  
  18.      XYZSHELL.PRG
  19.      XYZSHELL.RSC
  20.      XYZ.TTP (optional in the same directory)
  21.  
  22.  You can have XYZ.TTP in a different directory than the other  two 
  23. files, as the shell will ask you for the location of XYZ.TTP if it 
  24. can't locate it in the same directory.
  25.  
  26.  RUNNING THE SHELL
  27.  -----------------
  28.  
  29.   Any term program that allows running external commands  can  run 
  30. the shell.  Upon running the program you will be presented with  a 
  31. set  of options that you can click on to  choose. Certain  buttons 
  32. will only allow 1 button in a group to chosen.  In others you  can 
  33. choose a mixture of options.  Once you have made your choices  you 
  34. will be presented with a file selector box that you choose  either 
  35. the  file  to send or the path to use  for  BATCH  upload/download 
  36. protocalls.
  37.  
  38.  CHANGES
  39.  -------
  40.  
  41.   I  won't  go into great detail all of  the  changes  to  XYZ.TTP 
  42. itself.  I've  included  a  copy of the  compressed  package  that 
  43. includes  detailed  explanation.  I  will point out  some  of  the 
  44. features of 3.0 over 1.0. (what happened to 2.0 is too gruesome of 
  45. a story to go into) For information on the changes to 3.1 read the
  46. changes listed at the end of this document.
  47.  
  48.   o  -  The  XMODEM checksum mode has  now  been  moved  into  the 
  49. protocalls area.  Also when uploading OR downloading in XMODEM  1K 
  50. mode, ALWAYS choose the XMODEM 1K button. The shell will recognize 
  51. the  correct  calls to give to XYZ.TTP.  This was  a  problem  for 
  52. "some" new users to XYZ.TTP so this helps make it more uniform.
  53.  
  54.   o  - RETRY limit has been added to the  shell.  The  shell  will 
  55. normally default to 10 retrys per limit.  XYZ.TTP can actually  go 
  56. to 1000 but I set the shell to only accept a max of 999.  I figure 
  57. if  you're that much of a masochist that you actually want to  use 
  58. 1000  retrys  then run XYZ.TTP from a command  line.  The  current 
  59. amount  will  be shown on the shell.  If you deselect  the  RETRYS 
  60. button it will again default to 10 retrys.
  61.  
  62.  o - BAUD rate is for those modems running above 9600 if you  wish 
  63. to  have a read out of estimated time for the transfer.  It  works 
  64. similar to the RETRYS option and will default if deselcted.
  65.  
  66.   o  -  It is NOT recommended that you use  this  shell  with  any 
  67. previous  versions of XYZ.TTP as it *may* work but you lose out on 
  68. a lot of options.
  69.  
  70.  LEGAL STUFF
  71.  -----------
  72.  
  73.  I am not responsible for this shell affecting your system. It has 
  74. been tested and no ill effects have been found but you never  know 
  75. what may happen in your situation.
  76.  
  77.  XYZ.TTP is copyright of Alan Hamilton
  78.  
  79.  Any shareware contributions for XYZSHELL are seperate from shareware
  80. contributions for the TTP program. Please support SHAREWARE. Beats
  81. the heck out of commercial prices!
  82.  
  83.  NOTES
  84.  -----
  85.  
  86.   As  a  shareware offer I only request $5  for  the  effort.  All 
  87. shareware donations may be sent to:
  88.  
  89.  XYZSHELL
  90.  c/o Ken Cheek
  91.  10732 LaPlacida Ave Villa A3
  92.  Coral Springs, FL
  93.  33065
  94.  
  95.  You can also reach me at my BBS:
  96.  
  97.  B.U.B.B.A.
  98.  1200-2400
  99.  (305) 344-3644
  100.  Coral Springs, FL
  101.  
  102.   I hope you enjoy the shell as much as I have in making  a  great 
  103. program like XYZ.TTP a joy to use. 
  104.  
  105.  
  106.  CHANGES to 3.1
  107.  --------------
  108.  
  109.  You can now SAVE a configuration. When you first run XYZSHELL it will
  110. tell you that no configuration file exists. Once you've entered the
  111. shell, choose your most used options and then save it. When no config
  112. file is found, XYZSHELL will default to the following:
  113.  
  114.       Download
  115.       Xmodem 1K
  116.       Pause
  117.       Verbose
  118.  
  119.  The config file will only save your selected buttons. It will not
  120. save your retrys or your baud. If you choose to use other than the
  121. defaults on those options, you'll need to select them each time. (I'll
  122. probably add that capability later along with the ability to save a
  123. path)
  124.  
  125.  The DO IT button is now the default. Pressing your RETURN key will
  126. move you along without having to use your mouse to select DO IT.
  127.  
  128.  XYX.TTP's capability to write an error log has been added. If you
  129. choose LOG.TXT the shell will write a file called LOG.TXT to the
  130. drive/path that XYZSHELL is running from. If you choose VERBOSE, then
  131. LOG.TXT will be turned off. ie; you can have either VERBOSE or LOG.TXT
  132. but not both.
  133.  
  134.  The bug with the incorrect path name being shown on a file selector
  135. has been fixed.
  136.  
  137.  The bug with BATCH protocalls having to have a *.* placed on the file
  138. selectors filename has been fixed.
  139.  
  140.  CHANGES IN 3.2
  141.  --------------
  142.  This fixes the Zmodem download bug. Before if you wanted to do a 
  143. Zmodem download, you had to clear out the file selection. (the *.*)
  144. Now the shell will recognize when you want to dl in Zmodem and
  145. automaticly will strip the *.* off.
  146.  
  147.  Also, moved the DO IT button to the left. It just seems to make
  148. it easier if you use the mouse to click on it. Most times I don't
  149. change my options but I do change the protocalls frequently.
  150.  
  151.  CHANGES IN 3.3
  152.  --------------
  153.  It seems Alan pulled a fast one on me and changed how the batch
  154. protocalls accepted filenames. This version fixes the batch download
  155. problem where you would have to clear out the *.* in the filename
  156. of the file selector box. I've also removed the *.* permanently from
  157. that same box (except in the path) for a clean look.
  158.  
  159.  CHANGES IN 3.4
  160.  --------------
  161.  You can now set a drive as your default drive for uploads and
  162. downloads. Also, I enhanced the batch upload protocalls so that if
  163. you want to upload an entire directory, you no longer have to add
  164. the *.* to the fileselector. As far as the default drive goes, if
  165. you do not select a default drive, the shell will default to the
  166. current working drive.
  167.  
  168.  THANKS
  169.  ------
  170.  
  171.   Thanks  to  the  users that  have  sent  in  previous  shareware 
  172. contributions for earlier versions.  (if you've already sent in  a 
  173. shareware contribution it is not necessary to send another for the 
  174. upgrade.  Of course I wouldn't push it away! ....grin) Also, a big 
  175. thanks  to Andy Eklund (Phoenix) of The Stormbringer BBS  for  his 
  176. suggestions. (Besides, he wouldn't let me rest if I didn't mention 
  177. his name)
  178.  
  179.  I would've included YMG.TTP to this shell but was unable to make
  180. the shell work the YMG.TTP file. If the author would like to
  181. contact me with regards to clues as to how to make it work with
  182. the Pexec routines, I'm more than willing to spend the time
  183. coding in the routines.
  184.  
  185.